home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / programming / gui / textfield.lha / Textfield / History < prev    next >
Encoding:
Text File  |  1995-02-15  |  11.9 KB  |  298 lines
  1. ***************************************************************
  2. *                                                             *
  3. * This file contains the update notes on the textfield.gadget *
  4. *                                                             *
  5. ***************************************************************
  6.  
  7. Version 3.0
  8. -----------
  9.  
  10. NEW:
  11.  
  12. - The autodoc (and guide file) has been restructured into many more
  13.   sections so that pertinent information can be found more quickly.
  14.  
  15. - TEXTFIELD_TabSpaces is a new tag that when set to 0 does nothing,
  16.   but when set to a number greater than 0 sets how many spaces are
  17.   inserted at the cursor position when the TAB key is pressed.
  18.  
  19. - TEXTFIELD_NonPrintChars is a new tag that allows all characters
  20.   into the text buffer in case you have a font that makes use of
  21.   character position other than just Latin 1 printable.  See the
  22.   autodocs for more information.
  23.  
  24. - TEXTFIELD_GetCopyright() is a new function in the library that
  25.   returns a copyright string ready to use in a requester.  See the
  26.   autodocs and example program for more information on how to use
  27.   it.
  28.  
  29. - Now when you hold the SHIFT key and click in the gadget, text is
  30.   marked from the current cursor position to the place you clicked.
  31.  
  32. - You can double-click to mark whole words, or check the docs for
  33.   what happens when you don't click on words.
  34.  
  35.  
  36. FIXED:
  37.  
  38. - One copy of the 2.2 version made it out with a library version of
  39.   2.1.  A replacement version was made, but did not get picked up.
  40.   The library version is correct in this version.
  41.  
  42. - The fix to speed up clipboard functions in 2.x ended up not
  43.   freeing memory.  It's all fixed now.
  44.  
  45.  
  46. Version 2.2
  47. -----------
  48.  
  49. NEW:
  50.  
  51. - There is now support for HSPascal in the directory of the same
  52.   name.
  53.  
  54.  
  55. FIXED:
  56.  
  57. - It seems that in repairing the delete bug in 2.1 I missed some
  58.   other serious problems.  Backspace after two or more returns now
  59.   works.
  60.  
  61. - Minor: I also left out the main Textfield.info in the 2.1 archive.
  62.  
  63.  
  64. Version 2.1
  65. -----------
  66.  
  67. FIXED:
  68.  
  69. - To scroll you had to be more than one font height away from the
  70.   top or bottom of the gadget.  You only have to be outside the
  71.   gadget now.
  72.  
  73. - Pasting into the gadget is much faster.
  74.  
  75. - A serious bug with ALT BACKSPACE has been repaired.  The bug would
  76.   make it look like the computer was locked up, but really if you
  77.   waited long enough, you could get things back, but it was nasty.
  78.   In fact this is the first serious bug.
  79.  
  80.  
  81. Version 2.0
  82. -----------
  83.  
  84. NEW:
  85.  
  86. - The TextFieldAuto.c and <proto/textfield.h> now contain the
  87.   TextFieldBase like before, and also the TextFieldClass.  This
  88.   keeps the opening and getting of the class hidden for a simpler
  89.   API.  (If you already had a TextFieldClass variable of your own,
  90.   sorry, but you can just remove yours now.)  (SAS/C applicable)
  91.  
  92. - There are now keyboard commands to delete words at a time: Alt-
  93.   Backspace deletes a word at a time to the left of the cursor,
  94.   starting at the current cursor position (if you started at the
  95.   middle of a word, it deletes to the beginning of the word, like
  96.   you would think), Alt-Delete deletes a word at a time to the right
  97.   of the cursor, starting at the current cursor position (again, if
  98.   you are in the middle of a word, it only deletes the last part).
  99.  
  100. - There is a real line delete command now: CTRL-x.  It deletes
  101.   everything on the line.  It's not a command to delete all
  102.   characters between to CRs, though.  It's a visual line delete, not
  103.   conceptual line delete.
  104.  
  105. - Now when you click and drag to scroll the text display, the
  106.   further you are away from the actual gadget bounds, the faster it
  107.   will scroll.
  108.  
  109. - TEXTFIELD_ReadOnly is a new attribute that gives the user a read
  110.   only mode, but the user can still highlight text to use the
  111.   clipboard.  The old way of GA_Disabled and TEXTFIELD_NoGhost can
  112.   still be used for a read only mode without clipboard support.  It
  113.   is important to know that the client (program using the gadget)
  114.   can still add or delete text with TEXTFIELD_Text and
  115.   TEXTFIEL_InsertText.  See the autodoc for more details.  There are
  116.   issues discussed about which keyboard events get passed on to the
  117.   application.
  118.  
  119. - TEXTFIELD_Modified is a new attribute that allows you to tell
  120.   if the text in the gadget has been modified in any way.  It
  121.   to FALSE at creation time, but can be set or read at any time.
  122.   See the autodoc for more details
  123.  
  124. - TEXTFIELD_AcceptChars is a new atrribute that allows you to set
  125.   specifically which characters you will allow in your instance of
  126.   a textfield gadget.  Non-printable characters are still filtered
  127.   for you as usual.  These characters may not be accepted if they
  128.   are also included in the rejection characters.  Also see
  129.   TEXTFIELD_RejectChars.  And check the autodoc for more details.
  130.  
  131. - TEXTFIELD_RejectChars is a new attribute that allows you to set
  132.   specifically which characters to not allow in your instance of a
  133.   textfield gadget.  Non-printable characters are still automatically
  134.   rejected.  Characters listed here are always rejected.  Also see
  135.   TEXTFIELD_AcceptChars.  Check the autodoc for more details.
  136.  
  137. - TEXTFIELD_PassCommand is a flag that if TRUE will cause the gadget
  138.   to pass Right Amiga key sequences on to the application if the
  139.   gadget does not use it.  If FALSE, the gadget just eats the events
  140.   like it always has.  When this is TRUE and a Right Amiga key
  141.   command is received that the gadget does not use, the gadget is
  142.   forced to become inactive (not disabled).
  143.  
  144. - TEXTFIELD_LineLength lets you get a particular line size (the
  145.   number of characters on that line).  You pass the line you want
  146.   and that value gets replaced by that line's length.  See the autodoc
  147.   for some issues when using this.
  148.  
  149. - TEXTFIELD_SelectSize lets you turn on highlighting and set the
  150.   number of character to be highlighted.  It's always the number of
  151.   characters from the current cursor position.  If you pass 0, then
  152.   highlighting is turned off.  You can also get this attribute: 0
  153.   for no highlighting, otherwise returns the number of characters
  154.   highlighted.
  155.  
  156. - TEXTFIELD_MaxSizeBeep allows you to turn on beeping (DisplayBeep())
  157.   if text is entered when the buffer is full (buffer size equals the
  158.   size you passed to TEXTFIEL_MaxSize).
  159.  
  160. - TEXTFIELD_DeleteText allows you to delete text at the current
  161.   cursor position.  Only the size needs to be passed.  This gives
  162.   closure to the text insertion functions.
  163.  
  164. - GA_IntuiText allows you to give the gadget a list of IntuiTexts
  165.   that are rendered relative to the gadget's upper left corner.
  166.  
  167. /* MENU COMMANDS */
  168.  
  169. The following are implemented so that programmers can put them in
  170. a menu to give the user a visual interface to the RAMIGA keys.
  171.  
  172. - TEXTFIELD_Copy if text is highlighted, this will copy it to the
  173.   clipboard.  This command is just like RAMIGA-c when the gadget is
  174.   active.
  175.  
  176. - TEXTFIELD_CopyAll this always copies all the text to the clipboard.
  177.   This command does not affect the state of the gadget.
  178.  
  179. - TEXTFIELD_Cut if text is highlighted, this will erase the text and
  180.   put it on the clipboard.  This command is just like RAMIGA-x when
  181.   the gadget is active.
  182.  
  183. - TEXTFIELD_Paste pastes text from the clipboard to the current
  184.   cursor position.  If there was any highlighted text, it is deleted
  185.   first.  If you need to make sure that text is not highlighted first
  186.   then do set of TEXTFIELD_SelectSize, 0.  This command is just like
  187.   RAMIGA-v when the gadget is active.
  188.  
  189. - TEXTFIELD_Erase will remove all text from the gadget and place it
  190.   in the undo buffer.  This command is just like issuing RAMIGA-e
  191.   when the gadget is active.
  192.  
  193. - TEXTFIELD_Undo will paste from the undo buffer into the gadget,
  194.   just as if the user had hit RAMIGA-u when the gadget is active.
  195.  
  196.  
  197. FIXED:
  198.  
  199. - In V1.2, if you used the ActivateGadget() function on this gadget
  200.   it would get put into highlight mode, and therefore the first
  201.   typed key would be lost.
  202.  
  203. - In previous versions, if you had TEXTFIELD_Partial on, the partial
  204.   line would flicker when editing in the gadget.
  205.  
  206. - In previous versions, the TEXTFIELD_Text attribute did not cause
  207.   the cursor to move to the beginning.  It now does.
  208.  
  209. - TEXTFIELD_ClipStream2 now has a synonym: TEXTFIELD_UndoStream.  The
  210.   new name is easier to remember, but the old name can still be used.
  211.  
  212. - GA_Image used to be offset from the upper left corner of the
  213.   gadget's text box, not the upper left corner of the gadget itself.
  214.   It's now fixed.  (Only applies if border was set to something.)
  215.  
  216. - Apparently there is a bug in RectFill() in pre-3.0 OSes.  I've
  217.   taken measures not to be bit by the bug, which could have shown up
  218.   in previous versions of the gadget.
  219.  
  220. - There was a major effort on my part to update the autodoc to better
  221.   represent the features of the gadget.  It seems that I had really
  222.   only made a sparse effort before, and I apologize.  Each part of the
  223.   main documentation has a section title now.  The document has grown
  224.   by 16K.  I also apologize if you hate reading docs.  And I also
  225.   apologize if you hate apologies.
  226.  
  227. - A bug existed in previous versions that would allow you to have an
  228.   active textfield gadget even if it was disabled.  Specifically, if
  229.   you called ActivateGadget() on a disabled gadget, the gadget would
  230.   go active anyway.  (I thought the OS did that.)  It's fixed.
  231.  
  232. - The command to move backward by words (ALT-CURSOR left) would skip
  233.   a word if the was at the first of a line sometimes.
  234.  
  235.  
  236. Version 1.2
  237. -----------
  238.  
  239. - The name is no longer editor.gadget.  That name was too general,
  240.   as Christoph Feck pointed out.  The name textfield.gadget has
  241.   been chosen as the new name since it more accurately describes
  242.   the gadget's purpose.  So that you will know how to convert, here
  243.   is a list of files that have changed names that would affect
  244.   development:
  245.  
  246.   doc/editor_gc.doc                 ->  textfield_gc.doc
  247.   doc/editor_gc.guide               ->  textfield_gc.guide
  248.   fd/editor.fd                      ->  textfield.fd
  249.   gadgets/editor.gadget             ->  textfield.gadget
  250.   include/gadgets/editor.h          ->  textfield.h
  251.   include/pragmas/editor_pragmas.h  ->  textfield_pragmas.h
  252.   include/proto/editor.h            ->  textfield.h
  253.  
  254.   Also, in your source code I think I've made it easy to change, but
  255.   if you have problems, I'm very sorry.  Here's how: use your text
  256.   editor to replace all occurances of EDIT_ with TEXTFIELD_.
  257.  
  258. - The text pen now defaults to TEXTPEN instead of SHADOWPEN.
  259.  
  260. - The undo buffer is now cleared after you undo so that you don't
  261.   accidentally undo the same thing multiple times.  I should note
  262.   that the undo function just drops the text at the current
  263.   cursor position.
  264.  
  265. - As per request of a few people, the TEXTFIELD_Down event now
  266.   will not let the last line scroll to the top of the gadget, but
  267.   rather it stops at the bottom, like when you cursor down.
  268.  
  269. - There is no highlight or block mode anymore in the old sense
  270.   of turning it on and off.  You only need to click and drag
  271.   to highlight text.  Hitting any key replaces the highlighted
  272.   text like normal, and hitting backspace or delete removes the
  273.   highlighted text like normal.  The cut, copy, and paste keys
  274.   also work normally.  The new features are that the right and
  275.   down cursor keys unhighlight the text and take you to the
  276.   end of the highlighted text.  And the left and up cursor keys
  277.   unhighlight the text and take you to the front of the
  278.   highlighted text.  (This new method can make scrolling with with
  279.   the mouse pointer unfriendly, and you can accidentally delete
  280.   text after scrolling by hitting a single key, but if an undo IFF
  281.   stream is provided then the user can get the text back.  I have
  282.   asked many people whether they prefer single or double-click
  283.   block modes and it has been about 50-50.  This method conforms
  284.   to modern thinking, from what I understand.)
  285.  
  286. - A memory leak that occurred if the library was expunged has
  287.   been fixed.  It was usually about 4k.
  288.  
  289. - TEXTFIELD_CursorPos now will scroll the text to the position the
  290.   cursor is set to if needed.
  291.  
  292.  
  293. Version 1.1
  294. -----------
  295.  
  296. - The EDIT_Text now works in all cases.  It used to only work
  297.   on creation and get methods.
  298.